


TGRIND(1)           UNIX Programmer's Manual            TGRIND(1)



NAME
     tgrind - grind nice program listings using TeX

SYNOPSIS
     tgrind [ -f ] [ - ] [ -n ] [ -h header ] [ -d <description
     file> ] [ -l<language> ] name ...

DESCRIPTION
     T_g_r_i_n_d formats program sources in a nice style using _T_e_X(_1).
     Comments are placed in italics, keywords in bold face and
     strings in typewriter font.  Source file line numbers appear
     in the right margin (every 10 lines).  The start of a func-
     tion is indicated by the function name in large type in the
     right margin.

     In regular mode t_g_r_i_n_d processes its input file(s) and
     passes them to T_e_X(_1) for formating and output.

     In format mode (i.e., when the -f flag is used), t_g_r_i_n_d
     processes its input file(s) and writes the result to stan-
     dard output.  This output can be saved for later editting,
     inclusion in a larger document, etc.

     The options are:

     -f   forces format mode

     -    take input from standard input

     -n   don't boldface keywords

     -h   specifies text to go on the left side of every output
          page (default is none)

     -d   specifies the language definitions file (default is
          /usr/local/lib/vgrindefs)

     -l   specifies the language to use.  Currently known are
          PASCAL (-lp), RATFOR (-lr), Modula-2 (-lm2), MODEL (-
          lm), C (-lc or the default), ISP (-li), Yacc (-ly),
          Prolog (-lprolog), Icon (-lI), TeX (-ltex), CSH (-
          lcsh), and Bourne Shell (-lsh).

FILES
     tgrindmac.tex       macro package
     /usr/local/lib/tfontedprpreprocessor
     /usr/local/lib/vgrindefslanguage descriptions

AUTHOR
     Van Jacobson, Lawrence Berkeley Laboratory (based on
     "vgrind" by Dave Presotto & William Joy of UC Berkeley).




Printed 12/10/86                                                1






TGRIND(1)           UNIX Programmer's Manual            TGRIND(1)



SEE ALSO
     tex(1), vgrind(1), vgrindefs(5)

BUGS
     The marginal-function-name mechanism depends on the quality
     of the language description in v_g_r_i_n_d_e_f_s.  The distributed
     v_g_r_i_n_d_e_f_s fails to recognize many legal C function declara-
     tions.

     Arbitrary formatting styles for programs mostly look bad.
     The use of spaces to align source code often fails miserably
     (because of the variable width output font).  If you plan to
     t_g_r_i_n_d your program, try to use tabs.

     The indexing option of v_g_r_i_n_d is missing.  However, nice
     indices can be generated using the -v option of c_t_a_g_s
     together with appropriate TeX macros.

     The -f flag means different things to t_g_r_i_n_d and _v_g_r_i_n_d.




































Printed 12/10/86                                                2



program, try to use tabs.

     The indexing option of v_g_r_i_n_d is missing.  However, nice
     indices can be generated using the -v option of c_t_a_g_s
     together with appropriate TeX macros.

     The -f flag means different things to t_g_r